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15.  COMPUTER  PRODUCT  ABSTRACT 
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surface  and  sediment  bed  surface  profiles  by  computing  the  Interaction  between 
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16.  DATA  PILE  TECHNICAL  DESCRIPTION 


The  software  is  contained  on  S^s-inch  diskette  (s),  double 
density  (360K) ,  compatible  with  the  IBM/PC  microcomputer. 
The  diskettes  are  in  the  ASCII  format. 
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Two  si"  floppy  disk  drives,  or  one  5*"  floppy  disk  drive  and  a  10  MB  hard  disk. 
Math  coprocessor  (8087/80287/80387  or  equivalent)  is  required.  Hard  disk  is 
reniiired  in  order  to  run  the  menu  program  "MENU6". 
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IKSTAUATICM  INSIRULTIGMS  FOR  MICROOClC>Uira  VEISICXf  OF 

HBD-6 


This  version  of  HEC-C  (1  October.  1986)  will  run  on  an  IBM  ccmpatible 
microccmputer  that  has  the  following: 

*  512  Kilobytes  (KB)  of  Randcn  Access  Menory  (RAM) 

*  MS  DOS  2.1  or  greater 

*  Math  Ooprooessor  8087  ,  80287,  or  equivalent 

*  TMo  5  1/4  inch  double-sided  (360  KB  or  1.2  )C)  floppy  disketts  drives, 
or  one  5  1/4  inch  floppy  diskette  drive  and  a  10  Megabyte  (or  larger) 
hard  disk. 

Note:  To  run  the  HBC-6  nenu  program,  "MORIS”,  it  is  necessary  to  have  a 
herd  disk  system! ! ! 


OKIT  IMG  STAHllflJ 

Many  HEG  programs  require  the  capanility  to  open  more  than  ei^t  (8)  files 
at  any  one  time.  Because  ei^t  (8)  is  the  system  default,  you  will  need  to 
have  a  file  in  the  root  directory  (or  on  the  DOS  diskette)  called  CONFIG.SYS. 
This  file  should  contain  the  followinc  two  lines: 

FILES=20 

BUFFERS=10 

This  will  increase  the  number  of  possible  files  to  be  opened  from  eight  (8)  to 
twenty  (20),  and  it  will  also  increase  the  number  of  buffers  used  to  hold  data 
being  read  frcm  or  written  to  a  disk.  Using  BUFFERS=10  is  not  absolutely 
necessary,  but  this  number  is  suggested  for  program  efficiency.  You  can  use 
CX)ED  or  any  editor  to  create  or  edit  the  CONFIG.SYS  file.  If  you  have  not 
loaded  COED  onto  your  system  yet,  please  refer  to  the  COED  documentation  to  do 
so  (COED,  Corps  of  Engineers  Editor,  1987)  For  further  explanation  of  the 
CONFIG.SYS  file  consult  your  DOS  manual. 


program  iNSTAr  JATTnm 

The  HEC-6  conputer  program,  test  data,  test  output,  and  menu  system  cure 
provided  on  twD  5  1/4  inch  double-sided  360  KB  floppy  diskettes  as  follove: 


HEC6  DISKETTE  #1:  HEC6.EXE 
HEC6.DAT 
HEC6.0UT 


1 


HEC6  DISKETTE  #2;  MENU6.BAT 

HEC6MENU.EXE 

HECeMENU.DAT 

PARMS.DAT 

LIST.COM 

PR0UT.EXE 

README.DOC 

Backig)  copies  of  these  diskettes  shcxild  be  sade  If  you  have  a  tMO-floppy 
diskette  systea! ! ! 


A.  Erolanation  of  Files  Included  on  rhe  HEC6  Diskettes 

HEC6.EXE  :  The  HEC6  program  in  an  executabJe  form. 

HEC6.DAT  :  Example  data  input  file. 

HEC6.00T  :  Output  from  tne  example  data  "HEC6.DAT". 

MENU6.BAT  :  The  menu  system  batch  file  that  is  used  to  run  the  HEC6 
menu  programs. 

HEC6MENU.EXE  :  The  executable  portion  of  the  HEC6  menu  system. 

HEC6MENU.DAT  :  Data  file  for  the  HEC6  menu  program  which  contains 
information  about  the  menu  program. 

PARMS.DAT  :  Data  file  for  the  HEC6  menu  program  which  is  used  to 
pass  input  and  output  filenames  between  procpraras. 

LIST.COM  :  The  LIST  utility  program  provides  convenient  screen 
display  of  files  written  to  disk. 

PR0UT.EXE  ;  The  PROUT  utility  program  sends  output  files,  written 
to  disk,  to  the  pi  inter  with  carriage  control  invoked. 

README.DOC  :  File  containing  this  user  implementation  guide. 


B.  Installation  on  a  terd  Disk  System 

1.  Start  your  computer. 

2.  You  may  wish  to  have  all  program  related  files  reside  in  a 
subdirectory  on  the  hard  disk.  Assuming  that  C:  is  tlie  default 
drive  for  the  hard  disk,  create  the  subdirectory  ( "HEC6"  in  this 
exanple)  and  make  it  the  current  directory  with  the  following  MS 
IX)S  ccmnands: 

»t)\HBC6 

CD\HBC6 
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3.  Place  the  HEC6  diskette  #1  in  the  A  drive  and  use  the  following 
ccnmand  to  copy  the  files  to  the  IffiC6  subdirectory  on  the  hard 
disk: 

COPY  A:*.* 

4.  Place  the  HEC6  diskette  #2  in  the  A:  drive  and  use  the  same 
ccmnand: 

COPY  A:*.* 

NOTE;  You  itay  want  to  move  the  utilities  LIST  and  PROUT  to  the 
root  directory  so  they  can  be  accessed  from  any  directory. 

5.  You  are  now  ready  to  run  tl»  program.  Go  to  the  program  exemtion 
portion  of  this  document  (Part  A). 


C.  Installation  on  a  Tw- Floppy-Diskette  System 


There  is  no  installation  procedare  necessary  for  the  two-floppy- 
diskette  system.  Be  aware  that  without  a  hard  disk  you  will  not  be  able  to 
run  the  menu  system  (MENUS)  that  is  contained  on  diskette  #2.  You  will 
however  be  able  to  execute  the  program  by  itself.  Go  to  the  Program 
Executicxi  portion  of  this  documait  (Part  B) , 


PROGRAM  BCBCOnON 

A.  Execution  on  a  Hard  Disk  System 

You  are  now  ready  to  test  the  con^wter  program.  The  preferred  mode  of 
execution  is  throu^  the  menu  system,  thouctfi  you  can  run  the  program 
witho«at  going  through  the  menu.  To  ejcecute  the  program  through  the  menu 
system  do  the  following: 

1.  Go  to  the  directory  containing  the  HEC6  files  (e.g,  CD\HEC6) . 

2.  Type  ICMI6  and  press  the  enter  key.  This  will  invoke  the  batch 
file  used  to  run  the  menu  system  of  programs.  You  must  operate 
the  menu  system  through  this  batch  file  or  the  programs  will  not 
function  correctly. 

3.  On  the  screen  should  now  be  the  main  HEC6  Package  Menu,  as  shown 
in  Figure  1.  As  you  can  see  you  have  five  choices.  Before  you 
continue  please  review  the  section  on  the  HEC6  Package  Menu 
Program  in  this  doaJinent. 

4.  If  you  have  reviewed  the  section  on  the  HEC6  Package  Menu  you  will 
know  that  it  is  necessary  to  do  option  1  first,  unless  the  input 
file  that  you  wish  to  work  on  has  not  been  created  yet.  (If  the 
input  file  has  not  been  created  yet  you  will  need  to  do  option  two 
(2)  first.)  While  option  1  is  highli^ted  press  the  enter  key  and 
then  type  in  the  input  emd  output  names  in  the  pop  up  window.  For 
this  example  type  HEC6.0AT  for  the  irput  filename  and  the  name 
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HECS  Package  Menu 


1.  Define  input/output  files] 


2.  Create/edit  input  file 

3.  Run  HEC6 

4.  Display  output  to  console 

5.  Exit  to  DOS 


INPUT: 


( specify) 


OUTPUT:  CON 


Press  number  of  desired  option  or  T  i  with  <ENTER> 


January  1987  version 


FIGURE  1.  Main  HEC6  Package  Menu 
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of  your  choice  for  the  output  filename  (Do  not  use  HECe.OUT  for 
the  output  filename,  we  have  provided  a  file  with  this  name  to 
verify  your  results) . 

5.  The  next  JogjcaJ  step  would  he  option  2,  which  is  to  create  or 
edit  an  input  file.  For  now  we  will  bypass  this  step  since  the 
defined  ir^ut  fi.ie,  "HECb.DAT,"  already  exists  and  requires  no 
further  editing.  If  you  wish  to  create  or  edit  your  own  input 
file  you  may  use  this  option  to  do  so. 

6.  Now  select  option  3  which  is  to  run  HEC6.  Note  that  the  input  and 
output  filenames  are  passed  to  the  HEC6  program.  When  the  HEC6 
program  has  finished  executing,  you  should  see  tlie  message  "NORMAL 
HEC-6  TERMINATION."  To  return  control  back  to  the  main  HEC6 
Package  Menu  press  any  key. 

7.  At  this  point  you  may  want  to  view  the  outi.nit  on  the  screen,  to  do 
this  select  option  4.  V.i  ailing  output  on  the  screen  is  done  by 
executing  tlie  LIST  utility.  LIST  has  several  nice  features  for 
viewing  the  output  file.  To  become  more  familiar  with  the  LIST 
features  type  a  ?  while  an  the  LIST  utility.  To  get  out  of  LIST 
type  an  X,  which  will  terminate  the  program  auid  give  control  back 
to  the  HEC6  Package  Menu.  You  may  also  want  to  send  the  output  to 
the  printer  to  get  a  hard  copy.  This  can  be  accomplished  by 
toggling  the  printer  vising  the  space  bar  while  option  4  is 
highlighted,  and  then  pressing  the  enter  key. 

8.  At  this  point  you  can  exit  the  menu  program  by  invoking  option  5, 
or  you  can  continue  working  with  the  prevaous  four  options. 

B.  Exef^tipn  on  a  IVro-Flqppy-Diskette  System 

1.  Start  your  computer  (be  sure  that  you  have  already  made  backup 
copies  of  the  HEC6  diskettes) . 

2.  Place  HEC6  Diskette  #1,  with  t.ie  HECC.EXE  file,  into  Drive  B. 

Place  a  blank  formatted  diskette  into  Drive  A.  The  blank  diskette 
will  be  used  to  receive  outpat  data  and  scratch  files. 

3.  Make  sure  that  drive  A  is  the  default  drive,  the  pronpt  will  be 
"A>". 

4.  Start  the  execution  of  HE('6  by  entering  the  following  ccmmand: 

B:HBC6  INPUI^Inflle  OUIPWr=Outfile 


where; 


Infile:  The  filename  wJiere  the  HECb  input  data  resides 
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Outfiie:  The  filename  where  tl^je  output  data  will  be 

written.  If  tlie  user  wants  the  output  to  qo 
directly  to  the  screen  or  printer,  the  ccnmands 
CON  (screen)  or  LPTl  (printer)  can  be  used  in 
place  of  the  output  filename. 

For  this  example  type  the  following: 

B:HBC6  INEVT=«: HBC6.DAT  CUIPOT=TE5T6 . OUT 

Note:  If  the  input  and  output  filenames  are  not  specified  on  the 

execution  line,  the  program  will  prompt  you  for  them  in 
the  following  manner: 

ENTER  THE  FILENAME  FOR  INPUT  ( ]  -  (Type  filenane  here) 

ENTER  l-HE  FILENAME  FOR  OUTPUT  [  ]  -  (Type  filename  here) 

5.  Once  the  program  has  finished  executing  you  snould  get  the 
message  "NCMWAI.  HEC-6  TERMINATION."  If  you  did  not  get  this 
message  some  type  of  error  has  occurred.  View  the  output 
file  to  see  how  far  the  program  ran  before  the  error 
occurred.  This  should  help  you  find  the  problem. 


PROGRAM  VERIFICAriOM 

In  the  above  example  you  executed  tiie  HECb  program  by  using  the  example 
data  file  provided  to  you  on  diskette  #1 .  You  were  advised  to  create  your  own 
output  file  for  this  example.  At  this  poi.it  you  should  conpare  this  output 
file  with  the  one  provided  to  you  on  diskette  #1  (HEC6.0UT).  Check  your 
results  to  ensure  that  they  are  the  same  as  we  pixjvided  to  you.  This 

will  ensure  that  the  program  is  working  correctly  on  your  conputer  systan. 


HEC6  PACKAGE  l>gNU  PROGRAM 

A.  Fuipose  of  the  Program 

The  HEC6  package  menu,  MENU6,  has  been  created  to  aid  the  use:  in 
operating  the  HEC6  program.  The  menu  systan  provides  the  capability  to 
create  and  edit  input  files;  exeoite  the  HEC6  program;  amd  to  display 
output  conveniently  to  the  screen  or  the  printer.  The  following  provides  a 
description  of  the  menu  operation. 

B.  Program  Operation 

After  all  of  the  files  have  beeri  installed  on  you  hard  disk,  execute 
the  HEC6  package  menu  program  by  typing  MMU6  and  press  the  enter  key.  You 
must  execute  the  menu  system  through  this  batch  file  or  the  programs  will 
not  function  correctly.  On  the  screen  should  now  be  the  HEC6  Package  Menu 
as  shown  in  Figure  1.  As  you  can  see  t)Tere  are  five  choices,  with  the 
first  choice  being  highlighted.  Also  highlighted  is  a  status  line  at  the 
bottom  of  the  screen.  This  status  line  is  used  to  direct  the  user  on  how 


6 


to  proceed  at  any  point .  The  background  and  text  colors  of  the  menu  can  be 
changed  for  color  monitors  try  pressing  the  F9  and  FIO  keys  respectively. 

The  program  will  save  the  selected  colors  via  the  HEC6MENU.DAT  file. 

In  general  the  menu  operates  by  using  the  cursor  arrow  keys  to  move  to 
tne  desired  option  and  then  pressing  <ENTER>  to  execute  that  option. 

Another  way  to  execute  an  option  is  to  press  the  number  of  the  desired 
function.  Let's  talk  about  each  of  the  five  options  specifically; 

1.  tefine  ingut/qutput  files: 

This  option  is  used  to  define  the  target  input  and  output 
filenames  that  will  be  used  when  executing  HEC6.  When  this  option 
is  selected  a  pop  up  menu  will  a^^iear,  as  shown  in  B'igure  2,  which 
will  allow  you  to  enter  tlie  inpxit  and  output  filenames.  If  the 
input  file  already  exists,  this  option  should  be  done  first 
because  the  input  and  output  filenames  wilJ  be  paissed  by  the  menu 
program  to  all  other  programs.  If  the  input  file  does  not  exist, 
go  to  option  2  first.  Also  note  that  at  the  bottom  of  the  screen 
there  is  a  line  that  displays  the  names  of  the  current  input  and 
output  files  that  are  being  used. 

2.  Create/^it  irgput  file^ 

This  option  is  used  to  create  an  input  file,  or  to  edit  an 
existing  ir^Mt  file,  to  be  used  by  HEC6.  This  option  will  only 
function  if  you  have  also  obtained  the  full  screen  editor  COED  and 
loaded  it  on  to  your  system  ("COED,”  Corps  of  Engineers  Editor, 
February  1987) .  If  you  have  COED  on  your  system  this  option  will 
allow  you  to  go  into  the  full  screen  editor  with  the  previously 
defined  irput  filename  as  the  target  file.  While  in  COED  you  can 
create  or  edit  an  HEC6  input  data  file.  When  you  are  finished  the 
program  will  return  to  the  main  HEC6  Package  Menu.  For  help  in 
using  COED  refer  to  the  COED  user's  manual. 

3 .  Run  : 

This  option  executes  the  HECG  program.  The  input  and  output 
filenames,  defined  under  option  1,  will  be  passed  to  the  HEC6 
program.  When  the  program  is  finished  executing  you  should  get 
the  message  "NORMAL  HEC-6  TERMINATION”  if  your  input  data  was 
entered  correctly.  If  you  do  not  get  this  message,  more  than 
likely  there  is  an  error  in  your  input  data  file.  Review  the 
output  file  to  learn  more  about  any  possible  input  data  errors. 

If  no  errors  occurred,  and  the  "NORMAL  HEC-6  TEI?MINATION"  message 
was  printed,  just  press  any  key  to  return  to  the  main  HEC6  E^ogram 
Menu. 


7 


HECf>  Package  Menu 


1 .  Define  inpiit/output  filesj 


Input  file  .. .(specify) 


I  Output  file  ..CON 

Return  to  previous  menu 
5,  Exit  to  DOS 


INPUT:  (specify) 

output:  con 

Enter  filename  or  ?  Use  t  I  to  move  through  choices. 


January  1987  version 


FIGURE  2.  Define  inpnt/ouCput  files  menu. 
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Display  output  to  the  console: 

This  option  is  used  to  display  output  to  the  console  or  the 
printer.  To  switch  frcm  console  to  printer,  just  press  the  space 
bar  while  you  are  on  option  4  (In  other  words,  while  option  4  is 
hic^ilighted) .  If  you  choose  to  view  output  on  the  console  the 
utility  LIST  will  be  executed  with  the  output  filename  being 
passed  to  it.  If  you  choose  to  send  output  to  the  printer  the 
utility  PROUT  will  be  executed  with  the  output  filename  being 
passed  to  it.  Upon  connpletion  of  either  task,  control  will  be 
given  back  to  the  HEC6  Package  Menu. 

5.  &cit  to  DpSi 

If  this  option  is  chosen  it  is  assumed  that  you  are  conpletely 
finished  with  the  menu  system  and  control  is  given  back  to  DOS. 


PRDGRM4  PROBEJBMS 

If  any  errors  are  encountered  v*iich  indicate  potential  problems  in  the  HEC6 
executable  code,  please  contact  HEC. 

U.S.  Army  Corps  of  Engineers 

The  Hydrologic  Engir^ring  Center 

609  Second  Street 

Davis,  CA  95616 

USA 

tel.  (916)  551-1748 
(FTS)  460-1748 
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’  ^this  diskette  Is  intended  aainly  to  be  used  along  with  an  installation 
diskette  for  installing  COED  and  its  accessory  files  on  a  hard  disk. 
However,  COED  can  be  manually  installed  on  a  hard  disk  or  a  floppy  diskette 
by  the  procedure  given  below.  It  should  be  noted  that  either  a  hard  disk 
or  a  high  density  floppy  diskette  is  recommended  in  order  to  use  COED'S 
"Help  Progrzun"  feature. 

COED  requires  at  least  484  Kbytes  of  free  memory  and  DOS  2.1  (or 
later) .  The  math  coprocessor  is  not  needed.  The  \CONFIG.SYS  file  should 
contain  at  least  the  following:  FILES»15  and  BUFFERS^IO. 

The  COED  program  and  the  COED  accessory  files  are  in  an  archived  form. 
To  obtain  an  operational  copy,  they  must  be  un-archived  using  "PKXARC". 

The  files  contained  on  this  diskette  are  as  follows: 

File  Description 

COEDEXE.ARC  The  archived  executable  COED  progreua. 

COEDHLP.ARC  An  archived  file  containing  the  main  help  file  (for 
general  help) . 

COEDHPG.ARC  An  archived  file  containing  progrzua-help  files  to  aid 
in  data  entry  (e.g.,  for  entering  HEC2  data). 
COEDDOC.ARC  An  archived  form  of  the  February  1987  COED 
documentation . 

PKXARC.COM  The  program  that  un-archives  the  above  files. 

COED.XTK  A  command  file  for  the  coamunlcations  progrzua  Crosstalk 

(XVI)  that  may  be  used  when  connected  to  a  mainframe 
computer  with  COED. 

README. DOC  This  file. 


The  following  example  shows  how  to  un-archive  the  program  and  the  help 
files  from  the  A  drive  to  the  C  drive: 

A: PKXARC  a:coedexe  C:\ 

A: PKXARC  A:C0E0HLP  C:\ 

A: PKXARC  AzCOEDHPG  C:\ 

The  COED  documentation  can  be  un-archived  in  a  similar  manner,  if 
desired.  If  you  wish  to  store  the  files  under  a  different  directory,  that 
directory  is  specified  following  the  drive  letter.  If  the  files  are  to  be 
stored  on  floppy  diskettes,  they  must  be  formatted  and  have  at  least  360 
Kbytes  of  space  available  per  archived  file. 


